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LOCATION: Except for the annual 
meeting held in October of each 
year (held at NRC 120 Sussex Dr) 
meetings are held in the homes 
of the club members. For time 
and address contact M. Dove 
745-1779 or the BBS @ 745-8838 


TIME:Meetings are held at 8.00 
P.M. the second Tuesday of 
everu month (no meetings in 
Julu or August). 


FORMAT : 
1)—-President’s Address and 
introduction . of new 
members. 
2)-Software review (max of 20 


minutes). 
3)-Hardware review (max of 2@ 
minutes). 


4)-Adjourment of the formal 
part of the evening. 

5)-Informal: Members discuss 
common problems, swap 
programs, and exchange 
info (tips) etc. 


LDOS for ZX81/TS1000.....01011 
Selective Reprints ...... 10128 


Reprint of UPDATE 
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Membership list 1989/79. 190001 


MEET ING DATES 


Decemberi989 12th 
January 17970 9th 


February ' 13th 
March T 13th 
April = 1th 
May S Sth 
June àj 12th 
September ' iilth 
October P 16th 
November gj 13th 
December ' 1ith 


MAIL ING ADDRESS 


Please Address all 


correspondence to: 


Michael Dove 

The Editor 

OHTSUG 

2161 East Acres Rd., 
Gloucester, Ontario 
Canada KiJ V7AĠ 


ANMNUAL GENERAL. 
MEET ING 
At our annual meeting in 


October the following members 
were elected for the following 


year: NEW OFFICERS 


President — C. Raymond-Jones 
224-4547 

Administration — M. Dove 
745-1779 

Software — Bill Harmer 
%22-7184 

Treasurer — I. Ten-Holder 

~8-1058 

238-2327 

Librarian — D. Sally 
731-2126 

At our annual general 


meeting we discussed the state 
of our finance, projects for 
the next year, and the status 
of our BBS. 
We are in 


the process of 


taking out club membership 
with some other user groups. 
Hopefully the pooling of 


resources and information will 
benefit all concerned. 
Our decision to set up a 


BBS was made last spring at 
one of our monthly meetings. 
The BBS came on stream in 
as of October it had been 
running 24 hours a day. The 
BES was seen as a means to 
bring toghethor not only are 


club members but others across 
Canada and the States. As time 
and money allows the BES will 
be modified to meet the needs 
of the users. Further changes 
to the system will wait till 
the new year. 

Next month will see the 
last publication of our 
newsletter in its existing 
format. Subsequentiy it will 
be restructured for access 
thru the BRS. 
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FROM z EDITOR 
9 

Since the newsletter will 
reach others than those within 
our club I want to take this 
opportunity to give a little 
information on our BBS. 

Tel: 613-745-8838 

Hours of OPeration: 24 hrs/dy 


Protocol: X-modem 
Software: Larken Maxcom 
(Larken Electronics) 


Modem: Westridge 2050 

Baud: 380 

Parameters: 8/1/none 

The BBS supports message 
bases for General Chatter,Sysop, 
TSIBBB, TS206S $ emulators. The 
BES has upload and down load 


capacity for programs on Drive i 

At the present time we are 
considering to upgrade the BBS 
to a smart modem at 1200. A 1280 
modem will still support those 
using the 2050 but will shorten 
transfer time for those phoning 
the BERS (81200) outside Ottawa. 
A decision to upgrade the BBS 
will be made in January and will 


be influenced on the useage the 
system gets. 

At the present time the 
system runs in 32 column format 


but will shortly be converted ta 
64 column display. 

We especially 
comments and criticisms 
those using the BBs. If you 
logon as a guest pleare leave us 
an address so we can contact you 
if needed. 

The sysops are 

David Solly (Sig's & 


appreciate 
from 


Library) 
1545 Alta Vista Dr. 
Apt. 1482 


Ottawa Ontario 
613-751-2170 

Michael Dove (Hardware) 
2161 East Acres Rd. 
Gloucester Ontario 
613-745-1779 (home) 
613-745-8838 (BBS) 
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OTTAWA HULL TIMEX/SINCLAIR USER GROUP LIBRARV 
Tel: 731-2120 i 


NEW ACQUISITIONS 
MAY 1989 


The library has obtained many new acqusitions within 
the last few months most of which were generously donated by 
John Mathewson. 


Books 

1. Brain games : the world’s best games for two / by David 
Pritchard. 

a Basic computer games : microcomputer edition / edited 


by David H. Ahl. 


3. Some common Basic programs : third ec. / Len Poole, 
Mary Borchers. 


4, Microprocessor basics : selected from Electronic design 
/ editad by Michael S. Elphick. 


5: The complete Timex TS 1000 & Sinclair ZX31 ROM 
dissembly : parts A and B / lan Logan. 


6. HiSoft Pascal : manual for version 4.0 
7. ĦiSoft C compiler : manual for 1964 version. 
8. Beepers : 21 projects for the Timex/Sinclair 1000 and 


1500 / Gordon Rockmaker and Stephen Adams. 
9. Spectrum interfacing and projects / Graham Bishop. 


10. Sinclair ZX81 Basic programming, 2nd ed. / by Steven 
Vickers (The original British manuall. 


11. Timex user Manual : Timex Sinclair 1000 / Steven 
Vickers [the manual that came with the TS 10001. 


12. Games for your Timex-Sinclair 2000 / Peter Shaw. [The 


Oo 10% 


TS 2000 was a ZX Spectrum converted over for North 
American power and TV sets of which only a few were 
sold.] ’ 


13. The 8080A bugbook : microcomputer interfacing and 
programing / by Peter R. Rony et al. 


14. Getting acquainted with your ZX / by Tim Hartnell. 


15. Sixty programs for the Sinclair ZX Spectrum / Robert 
Erskine et al. 


16. The Timex Sinclair 2068 explored / Tim Hartnell. 


17. Astronomy on your computer : more uses for your 
Timex/Sinclair 1000 / Eric Burges, Howard Burges. 
[Programs can also be run on the TS 2068.] 


18. Basic course : the corplete Sinclair ZX31 Basic course. 
CAlso comes with software.l 


Book Bargains 


Kisber Liquidation, which currently has an outlet near 
the corner of Bank and Slater, has on sale at its computer 
table a number of books on the ZX81 and the Spectrum at give 
away prices. 


Usborne Computer Book Series 


If you have or know cnildren whe are interestad in 
computers you may want to iook into the Usborne Computer 
Book Series. This ig a highly illustrative and inform- ative 
series with programs designed to run on the Commodore 64, 
Vic 20, Apple, Spectrum and many other makes of computers. 
Severai different volumes from this series arse available 
from Kisber Liquidation and also from The Bookery of Ottawa, 
541 Sussex Drive. 


Periodicals 


The library has recently received, again with thanks to 
John Mathewson, a nearly complete set of the original 
Syntax publication from Harvard University. Bill Harmer is 
currently acting as custodian for this collection. 


Also — better late than never!! -~ the December 1988 
to May 1989 issues of Your Sinclair have arrived and are 


avaliable for circulation. All six issues came with a game 
cassette but, unfortunatly, only three (QMX, Alian 
Survivors, and Movies) will run on the Spectrum emulating TS 
2068. 


Gimme a call! Librarians get lonely too! 


If you are looking for information on the Sinclair 
computers or looking for a program that does 777 — give 
your friendly OHTSUG librarian a call at 731-2120. Chances 
are he has what you are looking for or knows someone who 


does. 
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Seven-Bit ASCII Text Filter 
For the TS 2068 
With Larken Disc I/O 


Article by 
David Solly 


Occasionally, after downloading a text file from an electronic 
bulletin board (BBS), or, converting HiSoft PASCAL source code 
files into an LKDOS file, the file may fail to write to the 
screen, print, or load into M-Script.l This kind of problem is 
most often caused by rogue bytes which enter the text through 
line noise, the process of conversion, or perhaps from the 
operating system of another word processor, and interfere with 
the Sinclair operating system. The following Pascal program, once 
compiled, will quickly load an LKDOS file or an ASCII text file, 
remove from the file any rogue bytes encountered, compact the 
file, and provide the user with opticn of saving to disc by 
overwriting the corrupted file or saving under a separate name. 
The PASCAL source code listed below was treated in this manner. 


LKDOS Files from Sinclair BASIC listings 


A Sinclair BASIC listing may also be converted into an LXKDOS 
file, however, the resulting file may still fail to lead ints M- 
Script or print on a full-sized printer. This is because in 
addition to the possibility of having picked up a few rogue bytes 
during conversion the listing may contain Sinclair block graphics 
and user defined graphics. These graphic characters pose a 
special prcklem because they fall neither within the range of 7- 
bit ASCII nor conform to any 8-bit ASCII standard. It is 
necessary, therefore, tc bring ali Sinclair graphics into the 
range of 7-bit ASCII before applying the filtering process by 
using this additional piece of code. 


1200 CONST 

1205 OFFSET = 79; (* Sinclair graphic to 7-bit ASCII *) 
1400 IF (LETTER IN [128..164]) THEN 

1410 POKE ( (START + COUNTER ), (LETTER — OFFSET) ); 


l IKDOS is able to convert Sinclair BASIC listings and some 
other types of tokenized texts into straight ASCII text and save 
them to disc as a sequential file. For this article they will be 
called LKDOS files. 


The final result of this piece of coding is to change all user 
defined graphics from UDG 'A' through to 'U' into normal ASCII 
'AT to 'U' and swop all the block graphics’ for a character 


between '1' and ‘@'. 


(* PROGRAM LISTING STARTS HERE *) 


SEVEN BIT ASCII FILTER 
PROGRAM BY 


DAVID SOLLY 


100 (*$2L-%) (xXx COMPILE OPTION, P. 35 IN MANUAL x) 


120 PROGRAM ASCIIFILTER; 


FOR LKDOS PARAMETERS x) 


ta 


125 (* STORAGE LOCATION 
130 CONST 

140 PROGNM = 23300; 
150 PROGSGN = 23311; 
160 PROGLN = 23313); 


180 START = #A028; (x TEXT FILE LOAD BUFFTR *) 
190 NEWSTART = #9C40; (* TEXT FILE COPY BUFFER *) 
220 VAR 

240 ANS : CHAR; 


290 PRINTABLE : SET OF CHAR; 
- 260 NEWLN; BYTES: 3 INIESER: 


290 PROCEDURE DOUT; (xXx INVOKES LKDOS WRITE x) 
300 BEGIN 


310 INLINE (#F3, ĦCD, #62, #00, #21, #04, #5B, Ail, 
320 #22, #20, #01, #09, #00, #7E, ĦFE, #00, 
330 #20, #02, #36, #20, ĦED, #AO, #78, ĦBI, 
340 #20, ĦF3, #3E, #0B, #32, #02, #20, ACD, 
350 #CC, #00, #2A, ĦOF, #5B, #22, #33, #20, 
360 #2A, #11, #5B, #22, #31, #20, #CD, #CF, 
370 #00, #3A, #64, #00, #FB); 

380 END; 


ODAN 


PROCEDURE DIN; (x INVOKES LKDOS READ x) 
BEGIN ' 
INLINE (#F3, #CD, #62, #00, #21, #04, #53, #11, 
#22, #20, #01, #09, #00, #7E, #FE, #00, 
#20, #02, #36, #20, ĦED, ĦAQ, #78, ABI, 
#20, #F3, #3E, #0B, #32, #02, #20, ACD, 
#76, #00, #R2A, FOF, #5B, #22, #32, #20, 
#2A, #11, #5B, #22, #31, #20, #CD, #C9, 
#00, #3A, #64, #00, #FB); 
END; 
PROCEDURE SPOUT (C CHAR); (* PASSES CODES TO THE ROM x) 
BEGIN 
INLINE (#FD, #21, #3A, ĦSC, ĦDD, #72, 
2, #D7) 
END; 
PROCEDURE AT (X, Y : INTEGER); (xXx EMULATES BASIC 'AT' x) 
BEGIN 
SPOUT (CHR(22)); 
SPOUT (CHR(X)); 
SPOUT (CHR(Y)); 
END; 
PROCEDURE CLS; (x EMULATES BASIC COMMAND x) 
BEGIN 
PAGE; 
SPOUT (CHR(22)); 
SPOUT (CHR(0O)); 
SPOUT (CHR(0)); 
END; 
PROCEDURE GETFILE; 


VAR 
FILENAME ARRAY C1..91 OF GHAR; 

BEGIN 

WRITELN; 

WRITELN ('FILE TO RETRIEVE FROM DISC? '); 

WRITELN; 

READLN; 

READ (FILENAME) ; 

POKE (PROGNM, FILENAME); 

WRITELN('HOW MANY BYTE IN FILE? '); 

WRITELN; 

READLN (BYTES); 

POKE (PROGLN,BVTES); 

POKE (PROGBGN, START); 

DIN; 


940 
950 
960 
970 
980 
990 
1000 
1010 
1020 
1030 
1040 


1070 
1080 


- -— 


END; (* GETFILE *) 


PROCEDURE STOREFILE(NEWLN : INTEGER); 


VAR 


FILENAME ARRAY (€1..9] OF CHAR; 


BEGIN 


WRITELN; 

WRITELN; 

WRITELN(’NEW NAME FOR FILE? '); 
WRITELN; 

READLN; 

READ (FILENAME) ; 

POKE (PROGNM, FILENAME) ; 

POKE (PROGBGN,NEWSTART) ; 

POKE (PROGLN, NEWLN); 

DOUT; 


END; (# SIOREFILE 9) 


PROCEDURE FILTES(VAS NEWLY $: INTEGER); 
VAR 
LETTER, COUNTER, SCRATCHED 


BEGIN 


~ 
- 


PRINTABLE 

COUNTER $ 
NEWLN : 
SCRATCHED = 


ee SE L 


ib di ow li 
ooon 


we 4 we 


CLS; AT(11,3); 
WRITE(’WORKING! KEEP YER SHIRT ON! ’); 


REPEAT 


LETTER := PEEK ( (START + COUNTER) , INTEGER); 


(X ENTER HERE ANY SPECIAL ROUTINE *) 
(* REQUIRED TO HANDLE SINCLAIR x) 
(* GRAPHICS OR 8 BIT CHARS *) 


IF (CHR(LETTER) IN PRINTABLE) OR 
(LETTER IN [13, 271) THEN 

POKE ( (NEWSTART + NEWLN) , LETTER) 
ELSE 


OVoolj 


1470 
1430 
1490 
1500 
1510 
1520 
1530 
1540 
1550 
1560 
1570 
1580 
1590 
1600 
1610 
1620 
1630 
1640 
1650 
1660 
1670 
1680 


SCRATCHED := SCRATCHED +1; ; 
COUNTER := COUNTER + 1; 
NEWLN >= COUNTER ~ SCRATCHED; 


UNTIL COUNTER = BYTES; 


CLS; AT(11,12); 
WRITE (’FINISHED! ’); 


AT(15,0); 
WRITELN('NO. OF LETTERS REMOVED: ', SCRATCHED) 
WRITELN; 

WRITELN(’NO. OF LETTERS COPIED: ', NEWLN); 
WRITELN; 

WRITELN( ORIGINAL LETTER COUNT: ', BYTES): 


END; (x FILTER x) 

BEGIN (x MAIN PROGRAM x) 

REPEAT 
CLS: .AT(S;OJ 
WRITELN('SEVEN BIT ASCII FILTER’); 
AT(7,0); di 
WRITELN('THIS PROGRAM IS FOR REMOVING’); 
WRITELN('STRAV CHARACTERS FROM AN ASCII’); 
WRITELN('FILE WHICH MIGHT INTERFERE’); 
WRITELN('IN THE NORMAL OPERATION OF A’); 
WRITELN('WORD PROCESSOR. '); 
GETFILE; 
FILTER(NEWLN); 
STOREFILE(NEWLN); 
WRITELN; 
WRITE('ANOTHER FILE? '); 
READLN; 
READ (ANS) ; 

UNTIL (ANS IN €’7N’, 'a')); 

WRITELN; 

WRITELN('TVPE RUN TO RESTART PROGRAM’); 


END. 


O\0\0 


. 
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EXCERPTS FROM BILL HARMER GUIDE TO THE LARKEN ZX81/TS100@ 


+ 


DISC SYSTEM 


Over the years Bill has gone to considerable effort to try to 
bring togethor information for the ZX81/TS000 computer system. 
Many of you may not be aware that Larry Kenny {Larken 
Electronics) at one time produced a disc system for the 
LX8B1/1TS10MB. Since little was ever produced for those having the 
disc system Bill decided to bring togethor in one pack 
information on LDOS. The manuscript is specific for the 
LX8B1/TS10BB sustem but seqments are still quite useful for 
anyone having the sytem for their 2048. Parts of his manuscript 


have been reproduced in part with the permission of Bill. 
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What You Need To Know To Use Your Disk System 


Once the disk drive system is hooked up to the computer (if not see 
section on hook-up in theLarken bock) he following steps are followed:- 


l. Plug in the computer and the disk drive power supply. 


2. Once the familiar square cursor comes up on the screen type in— 
PRINT USR 14336 e.. and then press enter or newline 


3. Take a fresh diskette out of the package and put it in the disk drive. 

The drive may have a door which you press closed once the diskette is 

in or a switch-like gate that you rotate clockwise to open, counter- 
clockwise to close (once the diskette is inside). : 


L. Once Step 2 is completed, . you will get a message on the screen as 
shown below:- 


LDCS 
k 


4 


Now type in FORMAT and press enter. If you make a typing mistake 
ou can rub out the bad part by pressing the deletes rubout key 
(shifted zero) on the ZX-81/TS1000. 


5. The formatting will take a couple of minutes, If you try to use an 
unformatted diskette you will get puzzling characters on the screen, 


6. Now take either a freshly formatted diskette or a used diskette made in 
a previous session ,one with ART room on it and (assuming you have at 
least a small program in the ZX-81/TS1000— like: 10 PRINT "TEST-¥; 

qe 20 GOTO 10 ) 


tvpe in the following: SAVE TIES IBI" eevand press enter or 
newline key. 
To save a program you must assign it a disk label name of up to 6 char- 
acters (but no more)then a period and then Bi or B2 or B3 ... (B plus 
a single digit number), The B stands for BASIC program, Exanocles: 


TEST.BL TEST; BY FROG1.EL 
MIPROG.BL GAME1.BL WORDFR.ES 
7. Now key in: SLOW and press enter or newline key 


PRINT USR 14336 and press enter or newline 
and once the familiar LDOS message and the x asterisk prompt appear, 


DIRE should be typed and and enter:or newline key 


Pt Le «oe 


(you may also type in DIRECTORY and press enter, instead). 
This will give you the directory of what is on the disk in terms of 
the list of file or program labels under which your material was 
saved and the number of 2K blocks on the disk that your program 
uses Up. 
8. To demonstrate loading the program: 


To get out of LDOS command mode (asterisk prompt) press enter several 
times until you are back to the square cursor (of the.ZX-81/TS1000 


bottom of screen, entry line). 
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What You Need To Know (Continued) 


9. Now type: PRINT USR 14336 and press enter or newline key, 


When LDOS and the x asterisk prompt are back, then: 


type DIRE and press enter or newline key (to get a directroy of 
programs on that diskette) and from this list you can then 
choose the program you want to load back into the computer — 


10. 


say TEST.B1 is shown on the directory on the screen as one of them — 


one will type LOAD "TEST.B1" and press enter or newline key. 


To run the program (if it does not start running automatically after 


11, 
loading):- 


CLS and press enter or newline key 
SLOW and press enter or newline 
GOTO 1 and press enter or newline 


Now the BASIC program loaded from the disk should start running. 


INDEX OF SIMPLE INSTRUCTION STEPS 


To FORMAT a blank diskette from the box.....steps 1.,2,3,4, 5 


To Save a program on a formated diskette.....steps 1,2, 6 


To see what is on the diskette in the drive 
(it is called pulling a directory)..... step 7 


To load a program and run it .....steps 9,10, ill 


To load a program land run it if it is a seiż-starting progran) 
vessen Steps 9, 10 


To hook up your disk drive system when it arrives in the 
mail ,.4440. SEE page 8-1/ 8- ik Larxen manuali p,9 


To learn more about the disk system's technical aspects....See p.7-1 


To set up and use self-starting programs (programs that start 
running right after they have been loaded from disk) 


To know how much space is left on a used diskette...» take the bottom 
number (of 2K blocks) on the screen after DIRE, subtract from 

To know how to prevent damage to diskettes and loss of programs 

b. oeeo SEE page 2-1 ,1-1,8-4 (items 4,5) 


What if I get funny characters on the screen and/or the message 


"CRC ERROR" ...... see page 4-2 
Recovering Info from a damaged/CRC error diskette p.4-2 


soitware and ine Larken Disk System ta 


- -—-— 


Your existing non-commercial BASIC programs, even those with machine language, 
can be adapted simply to load and run from disk. Copy prozected or other commerc- 
iallv marketed programs are a little more difficult to adast, but most can be fixed, 
Having your programs load from disk can save time and the frustration when a prog- 
ram crashes is reduced, knowing that reloading the program will take seconds rather 
than minutes, 

So now you want to start converting some of your commercial and key-entered 
(your own or from a magazine), programs to disk, First step is to find a sequence 
of unused line numbers, say right at the end of the program, so that you can easily 
spot the saving routine.Sane like 9500+; many use 9900sor 99904, The program must 
be stopped if it is an autostart one and LISTed, looking for this blank space at 
9000+ say, to put your disk save lines in, Methods for breakinga running program 
include pressing the break key even when the screen is blank, rub/out delete the 
left quotation mark in a string INPUT and enter STOP (shifted ‘A’ key) or even using 
LOAD CHR$ 832"" to load the program from tape (ins ead of LOAD"") and pressing 
BREAK in the slack screen period right after the program has loaded and before it 
comes up on the screen. 

To simply save the program without the autostart feature, once it is LISTed, 
.and STOPred find what command is needed to start it running (not all programs go 
to line 1 to start) and write that down for future reference. Look for the rcas- 
sette autoload program lines (see below), that the original pregrammer may nave 
used to get it to autostart after a cassette lcad for a clue as to how to start-ur 
the program. Note that there may be two such routines, one to save just the oroz- 
ram and another to save the program and data entered into it by the user, The firel 


Step: is to enter PRINT USR 14330 (in Basic immeciace comieud zace SS as a prossaż 
Tr ae 
f 





ae 


line), and enter on the LDCS command screen (after the 4) SAVE" poetae L'i, Note toc 
hat SAVES is spelled out, S-A-V-E not the one-key token (on tne 'S' key). 
In looking at the disk autostart routine, first compare a typical cassette 
autostart routine: 
9000: REM CASSST = SAVE RCUTIAE = AUTCSTART 
9010 CLS 
9020 PRINT "CaSSETTS2 SAVS BEGINNL.G" 
9030 PAUSE 200 
SOLO CLS 
9050 SAVE PROG" 
9060 CLS 
9070 GOTO 1 
Some programsuse a RUN 1 or sucn lixe if you are not starting up with any 
data or variable values left-over from the last running (for it clears then with 
pPoubizet 


RUN). This compares with the non-autostart cassette save 


9000 REM CASSETTE SAVE -NCT AUTCS TART 
9010 CLS 

9020 SAVE™MY?RCG" 

9030 STOP 


To do the same with disk just substitute for tne cassette save comand line, 
two lines, RAND USR 14336 and then REM SAVE"PROGX.B1L". An example of this is: 


9990 REM NON-AUTOSTART DISK SAVE iżotkam eee: 
9994 RAND USR 14336 9994 LET ERsUSA 14336 

9996 REM SAVETPROGX , BIT to save the error result (reg. 
9999 STOP BC contents)in the variable ER 


This will at least prevent you from forgetting the name of the program on 
disk or mistyping it on on save. You may want to use an autostart program module 
instead of this, as wegenerally do, but this listing will help you at least to 
better compare disk and cassette equivalent procedures, 

The pausing routines LET X=PI wa PI are a very memory economical way of put- 


ting in a momentary pause to avoid disk spoiling by the fist seqeunce of disk 
operations pessible when a save etc. is done from within BASIC., See next page. 


D.3-3 

ADAPTING PROGRAMS FOR DISK DRIVE CONTINUED 

95CO REM DISK SAVE . 

9510 LET X-PIumPI 

9520 PRINT USR 14336 

9530 REM SAVE TPROGI,BIT 

9540 SLOW 

9550 CLS Note: A CLS can be added 

9560 GOTO 1 as line 9505, Also see notes 


at bottom of page. 

Now. with these two routines within the program somewhere out-of-the-wa 
Simply key > in the immediate command GOTO 9000 for a cassette save and ġia 
GOTO 9500 for a disk save, The appropriate save routine nowcan be accessed 
so that on loading from cassette or disk the next time the rroceram would 
be self-sterting at line 1. miti 

Further program refinements (see p.4-3) can allow too the access of 

a GOTO 9000 or GOTO 9500 by choosing on a menu the onticn of saving on 
cassette or disk, So with a few simple additions the rrograzzs could be 
adapted to run conveniently on the Larken disk system and still allew 
Saving on cassette for swanving programs or back-ur. l 

Another disk save routine has been used to doubie check the save on 
the diskette by allowing the option of doing a disk directory with the 
press of a single key once the GOTO 9500 routine is invoked, Scmetimes 
the cisk operating svstem will anpear to save vour program but ict reai- 
ly do it and it indicates this in the directory by showins a f ovvosite 
tne file label to indicate that no blocks have been assisned to this 


file and that in fact it kesn't been saved. The routine is as follows: 
9500 REM DISK SAVE See Hortas below, 
0570. CLS 


9515 LET X=PI*xPI 

9520 PRINT USR 14336 

0530 REM SAVE TPROGI.BI' 

S50 SLOW 

9550 PRINT "VERIFY? (Y OR N)”. 
9560 IF INKEXŻO "Y" AND INKEZJOH THEN GOTO 3610 
9570 IF ZNKEYS="" THEN GOTO 9550 
9580 LET X=Pix#PI 

9590 PRINT USR 14336 

9600 REM BIRE 

8610 CLS 


9620 GOTO 1 A 
Sometimes there is a false "yes" response with the INKEX; but general- 


ly this routine saves a lot of headaches and requires only a single key- 
stroke to use, An alternative routine uses INPUT instead of INKEYŞ. It 
is amazing to think that our little computer allows self-starting preg- 
rams that even the Commodore 64 doesn't allow normally. 


Note:1)The SLOW is there because the computer will otherwise come back 
from a load in FAST mode and go on to run the program in FAST mode 
while most programs are made to run in SLOW mode. If you want 
the program to start up in FAST mode leave out this line. 


2)The seemingly meaningless formula LET X=PIsePI is included in 
order to provide a short pause of a moment or two to let the 
disk drive motor stop. Otherwise on some disk drives the disk- 
ette in the drive might be spoiled by going to this part of 


the program too cuickly. 
Due perhaps to keyboard glitches related to debouncing, 
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There are a number of ways to make a disk drive interface, One 
uses a special disk drive controller chip. These were too expensive when 
the Larken System was first built and so were not used. Another method is 
to use a second microprocessor or a microcomputer-on-a-ehip like the Z-8, 
Again that would be both expensive and mean a lot of extra work, The sol- 
ution eventually chosen was to use the Z-80 of the ZX-81/TS1000 as the micro- 
processor, This will do disk operations by running off a disk operating pro 
gram stored in a separate ROM on the interface board, This is hung on the 
address bus of the computer (via the expansion/RAM pack slot on the back of 
the computer) and uses addresses in the 8K-1fK area not used by the ZX-81/ 
TS1000 (but used by some aftermarket accessories}. The ROM is 2K bytes and 
a 2K RAM buffer is located slong side it in the 8K-16K address area, 

The disk operating system had to mesh with the operating system of the 
ZX-81/TS1000 (a monolithic monitor rather than a kernel with device drivers). 
Since a machine language routine can be run under ZX-81 BASIC without inter- 
rupting the display in SLOW mode, i.e. the normal screen update and output 
(through a port to the video output), character generation etc.,the obvicus 
thing was to run the Larken DOS as a simple machine language program running 
under BASIC, Accessed withthe BASIC PRINT USR 14336 ccmmand the m/e DOS 
is not in a REM statement in RAM but in ROM on the interface board. The 
m/c Larken DOS on ROM first comes up with a screen display, the prompt > 
and waits for a command to enter one of the modules of the m/c DCS program 
such as SAVE or FORMAT, In order to avoid cursor problems, the program 
acceptsSAVE spelled out S-A-V-E rather than the BASIC cassette save token we 
enter in one keystroke, When the disk operations are completed the eg. SAVZ 

rogram is exited and one is back to the-mode’one left, This would be either 
the LDOS immediate command mode screen (frem.which you get a directroy) or 
the next program line after the REM statement,if called from within a BASIC 
program that is running... It checks the TS1000 system variable PPC to tell, 

The format of the Larken disk is double-sided, 5% inch commonly although 
systems with some other formats have been produced. There is no real adv- 
antage in using 31 inch as far as capacity is concerned because the capacity 
is limited by other factors, Too,the single-sided 52 inch diskette is naif the 
capacity of the 54 inch double-sided. Single sided systems were produced to 
meet the needs of users who already had a single sided disk drive from anoth- 
er computer that they could use with the Larken system instead of buying a 
new one, double sided. With a disk operating system on disk, a double-siced 
system can use single-sided diskettes. Such a system is available from 
Larken (or was). As for 8 inch and others, experiment is the ruie,no guaranty. 

Is the information on the disk in ASCII? No, it is in tne 7L-£1/TS1000 
code, Single key tokens and all, as seen in the table at the back cf the 
computer's user manual. There is no provision in the ouiit-in Sinclair 
BASIC to save a file or program in ASCII although some users have written 
programs to partially or more convert text etc, to ASCII. Some modem prog- 
rams have modules to do this too as well as tape upload (to TS2068) programs. 

The Larken system puts data or programs onto tne diskette in bioċxs, 
misleadingly referred tofas tracks in the original manual, A stanċarz Dg" 
douole-sidei diskezte has 40 tracks. Each track is a different distance from 
the centre. So, one block {nearly 2K), a buffer full of data can be stored 
on the ton side of the diskette for each track and another on the bottom 
side of she diskette at that track number (and position). So, with kO 
tracks, vou can get 2 blocks per track (one on the top of the iskette,tane 
other on the bottom) making 80 blocks per diskette, or 80 blocks times al- 
most 2X per block and you have 160K per double-sided disk, single density 
storare rules used. Sectors, each with a start marker on a track,are not used. 

As explained earlier in a technical note, each RAM buffer contains less 
than 2% of data to be written to the disk since it is also used to store 
the values of the LDCS system variables (rather than trying to splice them 
into the ZX-81/TS1000 operating system somehow), These system variables 


include Cline(Command Line), curtrk(current, track); and in the first 24 bytes 
# data address and data length. 


F Ca 


of the buffer, sumcheck, file name, track jf, 
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How The Larken System Works (Continued) 


The Larken system uses generally a 54 inch DSDD disk drive (floppy 
disk drive) with Shuggart being the only recommended one of the US, drives 
and CanonerPanasonic being among the recommended Japanese’ drives for the 
System, Original advertisements mentioned reconditioned, used Remex drives 
for $50 or so to save further on the price of a system but these proved 
troublesome in practice, many out of the batch being faulty and although 
the ROM had been modified for use with them (in order to take advantage of 
their faster than averaze access speed) most users have switched to a new 
drive, The system is said to be usable with 34 inch disk drives although that 
would be a waste of money because the same amount of data would be save 
on them and both the disks and the drives are more expensive than 5# inch 
ones, To get more than150% needs a new DOS. -entirely. ‘Some systems. used ia ROM 
modified to FORMAT a single-sided diskette (for the use of single-sided 
54 inch disk drives, once popular and cheaper than the double-sided ones) 
and so have half as much (about 80K rather than 16CK) as the standard double 
Sided disk systems. A few boards are around thet can handle two drives at 
once (for easier disk copying) tut these were sold at extra price and are 
not the commonest kind, It is said that in using the 34 inch disk drives 
one could save more than on the 52 if the ROM routines on the interface board 
were to te modified, but they would still only save single-densitv and the 
number of blocks is limited by LDOS operating system algorithms to at most 
121, while the standard number (in the Se ROM's) is 80. Using an 8" 
drive would be a novelty but since 8" diskettes are expensive unless you can 
get some used ones surplus, that is hardly a practicai way to go, and their 
'footprint' on ones computer table is enormously large. Using brands of 
US disk drive other than Shuggart, not to mention any non-standard old ones 
can run you into difficulties with reliability and timing compatibility 
with the ROM routines. So the unconventional may have a hidden price. Why 
choose to pay it? Of course if you are a veteran hardware hacker, why not? 
Disk drives usually have two motors, a sterner moter that moves +h 
head position different distances from the hub (sig nole in the disxe: 
Each pulse to the motor will move it one step along, either in cne cir 
ion fin) or in the other (out), The main motor rotates the dis so th 
the head can ride over it on a layer of air. The mctor must first te 
started so bring it up to speed before any read or write oreraticn to the 
diskette is started. A typical disk drive hes a printed circuit scared full 
of integrated circuits mounted on the box. Mechanical as well as electron- 
ic adjustments (trim pots) are usually found as well as perhaps DI” switches. 
Two connectors come off tnem, One is aribbon connector sios for parallel data 
and motor control lines, Fower to the motors and the electrenics on the 
printed circuit board on the disk drive (45 V., +12 v.) is on a Barrow slot. 
The head azimuth can be adjusted (mechanically) in most drives and 
the heads can be cleaned (with alcohol) bus theseoperations are very fine 
ones and should only be performed by someone who has been shown now to do 
it under technical supervision, The heads ae easily camaged by improper 
cleaning. Readjustment of the azimuth will make diskettes already used on 
that disk drive (ampossibly any others) unreadable if it isn't set back 
to its original and proper setting exactly. 
For the details of the Larken system parameters, see page 7-4. For the 
moment it suffices to say that the system will take data (that is BASIC pro- 
grams from the ZX-81/TS1000 computer -main RAM) and load it into the RAM on 
the disk interface board in blocks of 1960 bytes (just under 2K). This is 
combined with a set of system information in its first 24 bytes, FF plus 
the block number (f-79), the file name (e.g. EXAMPL.B1), starting address 
in computer RAM of the data being saved (LSB then MSB), and the length of 
the data (LSB then MSB), 9 bytes reserved for the sumcheck, then 1960 bytes 


of data from the computers main RAM. Loading is just the Opposite process, 
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Memory Locations—ZxX-€1/ TS1000 
With Larken Disk System See p.7-2ot)for expla: 
of tracks versus 


ZX-81/TS1000 (all addresses in base cen) £ blocks confusion. 


Memory Location where earliest machine coce can be inserted in first 
REM statement is fixed (rather than floating with TS2068) at 16514 


Memory Location where screen file starts is floating (not.fixed as with 
TS 2068) at: PEEK 16396 4-256mPLEK 16397 


Memory location where BASIC operating system for computer starts in ROM: Ø 
(RCM ends at 8191) 
Memory Location to which microprocessor goes to seek instructions when 
reset: 


Users/Application Program Starts at memory location (RAM): 16509 
ROM Address where LDOS disk operating system starts: 14336 (3809 hex) 
Location of RAMTOP, a system variable for the ZX-81/TS1000 is fixed at: 
memory locatiors16388 and 16389 and the value of RAMTGP can be 
found, so that RAMTOP-(PEEK 16388 425Ew7EEK 16383) 
PPC (RAM)(16392) -equals 255 (FF hex) if computer is in command mode or LDCS 
is in screen command mode rather than teing activated from within a 
BASIC program, Fe 
System Variables for LDCS disk operating system are stored in a separate 


Ħam on tne Gdisk iflucrface board, 


Current block number (f-79) - 12239 (eurora 
Command Line (where current -12316 (Cline) 
D command is stored) 


Data Buffer begins at 12352 and the first 24 bytes 
contain the variables for LDOS saved in one 
block of data (or loaded ia one olcex) 
including: 

sumcheck 
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A 
12301,(LSB), 12305 (MSB)-- date aicr 
12306(LSB), 12307 (MSB)-- Ienzzn ic 
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Actual Data being saved or loadec starts at 12376 in the 
Gata vufier area wiien is 10°C vias lone ma 
and ends at address 14336 (24M on disk inzerizce 


board which is 2K in all) 


Port used for saves and loads to turn the disk ċrive motor on or off etc. 
is core 69 (base 10) and the code used is: 
(1sb) it Ø - stepper pulse (stepper motor positions head) 


bit I1 - stepper direction fin or out from center hub) 
bit 2 - select side of diskette (top or bottom) to access 
bit 3 - main motor on (main motor rotates diskette) 


bit 4 - write enable (write to disk rather than just read) 
for example OUT 8 at port 69 will turn motor on 


pan ab ee «8 4 oe ae ee 


ROM Calls For Disk Cperating System 
To Load the buffer- 14546 (loadbf) To set the block 7 -14778 (settrk) 
To Save the buffer- 14861 (savebf) Increment block # -14763 (nextrk) 


Cutput data to a port -16374 (output) Sort (interpret eget in Cline)- 
INTA 
(This ROM is on the disk interface board). 
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How The Larken System Works - Disk Organization 


A 54" DSDD diskette is theoretically capable of holding 500K of data (DD) 
although the standard MS DOS computers that have made them famous use onlv 
part of that capacity and store only 360K on them. The Larken system by 
limiting the storage method to single density cuts that maximum (500K) in 
half from the start to 250K, If the MS DOS.and.Larken--system use 40 tracks,ve 
see then there are 40 positionings of the head from the centre of the | 
diskette and at each position you can store two blocks of data, one on the 
top of the diskette and one on the bottom. The MS DOS computers can on 
double density store 5K in each of these positions. '. The Larken system 
is limited to storing half that or 23K by virtue of using only single density 
ity storage methods and further cut down to 2K by the use of only a 2K RAM 
buffer on the interface board. This is further cut down tp 1960 bytes by 
the use of some of that RAM to store LDOS system variables*and other bytes 
in it to store special information on the disk so that the disk operating 
system can run more efficiently and not get confused. A further block of 
2K is lost to data storase as it is used to store the information needed 
to pull a directory offthe disk (with a minumum amount of wear and tear 
and wasted time instead of hunting all through the disk for it) Also here isa 
Block Map (somewhat equivalent to the FAT, File Allocation Tabie in MS DOS). 

The first block (#9), contains the directory for the diskette and the 
Block Map. = The 80 bytes reserved for the Block Map contain originally 
the numbers 1 to 79 for the blocks 1 to 79 (block f is not incluced since it 
is always used - for the directory, and Block Map). If a block is beinz 
used to store a file (a BASIC program typically), then 123 is added tc it 
(that is bit 7 is set, bits in a byte go from Ø to 7 right tc left, lsbdefth. 

In the directory there are (after a marker, 253 in base 10), the fils 
names(e.g. EXAMPL.B1), Therefollows in order, the tracks used to store the 
file (plus 128 in each case) Then after,all the tracks are listed 24 spaces 
are allowed for this making the maximum file size 4€K, incidently , A marker 
249 (in base 10) is placed to indicate that there are no more (the use of 
such a code thus also limits the number of blocks). & summary of the disk 


codes is as follows: 


LDOS Disk Codes:. ~addinge 125 to a block number (settings bit 7, NSB) 
makes the block number indicate the bloch is 


currently in use 
~-255,bezinnings of a block or other general marker 
-254, block deleted or not used 
e249, end of iist of tracks used for a given file 
(Shey are listed in block #8, the direccory 
block, after Sna 22 le Sere 6226 oe 
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20293. end of file namne zarker (e.g. ESAMESs31,2521 
225/, end of directory marker 


for in allocation of space 


There are 52 possible directory names allowed 
for names and block numbers in the block used ror this (block #0). Zach 
file name (e.g. EXAMPL.B1) must have the veriod and a letter (only one of 
A, array, B, BASIC program, C, machine coce program), and then one number 
(A to 9): Maximum file name length (the part before the period) is 6 char- 
acters and characters having codes over 248 can't be used (since they might 
be confused with markers). In the ZX-81/TS1000 these are all BASIC command 
codes, RAND, IF, CLS, UNPLOT, RETURN, and CCPY. Of course if the file name 
were to be for some strange rezson in ASCII or the tokens of another comput- 
er make or model, there might be trouble, This isanother source of incompati- 
bility ĦD Also difficulties mizht arise is in a program running machine 
code that has the same effect as POKES or a BASIC program that uses POKES 
in a random way. Also glitches in the electronics could cause changes in 
such binarv information, See rage -5 (Item 4)for more on this, 

X incom ati ilitv with computers using disks with ASCII, etc. codes. 

aNot sdved on the disk, 


INTERESTING TID-BITS 


I am including with the rest of this publication a couple of 
articles which came from the last publications of Suncware News. 
Some may have seen them, if so I apologize, the articles are 
however short and the take home message easily understood. 

The last few pages are taken from UPDATE ComputerSystems. 
You may or may not have seen the article. I have reprinted the 
article as I feel very strongly that any diehard Sinclair user 
ought to support where posible publications which support our 


computer system. 
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SPARE THAT 2068 SCREEN 


Every schoolboy knows that you shouldn't 
leave your monitor or TY screen standing 
{dle for a long time with a static pattern 
on ft. (That's why the TV people caution you 
not to leave your MUTE command in effect for 
a long time--turn the volume down instead.) 
Anyone who ignores this warning is in danger 
of suffering phosphor burn-out--the part of 
the monitor (or TV) screen that is 
{lluminated by the electron beam (the bright 
areas, that is) wears out faster than the 
rest of the screen, and the screen sooner or 
Tater takes on a permanent impression of the 
pattern. 


It's sort of (but not exactly) like the 
after-image that you see when you close your 
eyes after looking at a brightly illuminated 
scene. Luckily, fn the case of your eyes, 
the fatigue wears off after a while, unless 
the light has been bright enough to cause 
permanent damage. 


So we are always warned to turn off the 
monitor when we are not using the computer. 
Or at least to turn down the brightness. 
Well, here fs a mini-program that has the 
same effect, with only a few keystrokes 
required to activate it. 


Include in your TS2068 program the following 
line: - 


9999 BORDER O: PAPER 0: INK 0: 
CLS: PAUSE 0: BORDER 7: PAPER 
7: GO TO 1 


Gf course, you can have the PAPER, BORDER, 
and INK colors be whatever you like after 
the PAUSE. Similarly, you can locate this 
rs.tine at any line number that's convenient 
.1: though you may want to nrecede it with a 
S..P, tn order to keep it from being 
activated at the wrong time). And the final 
GO TO 1 can be replaced with anything you 
want. 


SO whenever you want to leave your computer 
for a while, you can put the monitor to 
Sleep" by GO TO 9999, and everything will 
go dark until you touch a key. When you do 
touch any key, the program restores the 
Colors you want, and resumes operation at 
the line you've chosen. 


You can make this even easier by including 
in Line 1 (or some other line) the command 


LET G=9999 


yen your “hibernate” command is just a 
mple GO TO G, which is about the easiest 
ommand there is. If you do decide to do 





things this way, be sure that you include a 
provision to redefine G=9999 whenever the 
program RUNs or CLEARs. Or you can include 
SLEEP as a menu option. 


You can do something similar with the 
TS1000, by having it PRINT a screenful of 
inverse spaces, but I don't know of any way 
to protect the BORDER area. 
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DON'T CLOG YOUR MEMORY WITH GOSUBs 


Perhaps you didn't mow that you can exhaust the 
memory of your TS 2068 in a surprisingly short 
time, if you repeatedly use a GOSUB without a 
corresponding RETURN. 


Try the following: 


100 PRINT “FREE BYTES: “; FREE 
110 LET N=1 

120 PRINT AT 3,0;N 

130 LET N=N+tl 

140 GOSUB 120 


and RUN the program. You'll get an OUT OF MEMCRY 
report when N=78. 


What happens, of course, is that the the computer 
saves up all of those addresses that it should have 
RETURNed to, stacking them neatly in a corner of 
the memory that it has reserved for this purpose. 
When that corner is full, you're OUT OF MEMORY, 
regardies of how many empty bytes may be lying 
around elsewnere. 


You can get a bit more of an insight by adding the 
following line: 


10 DIM A(1000) 


You'll see that, although FREE (the number of free 
bytes of memory) has been decreased by 5000, the 
number of unrequited GOSUBs that the memory can 
accommodate is unchanged, 


You might liken this effect to an embolus that 
blocks a strategic blood vessel, shutting down the 
body even though the rest of the cardio-vascular 


system is unimpaired. 
THE MORAL 
Obviously, the first thing to make sure of is to 


provide a RETURN for every GOSUB you include in the 
program. But a more subtle point--make sure that 


~~ AOW 


the RETURN command ACTUALLY GETS USED. There are 
two very real possible pitfalls: 


First, watch the program itself. It's all too easy 

to route the program around that vital RETURN (as 
the result, for instance, of an IF ... THEN 
statement), 


Second, be careful not to BREAK the program in the 
middle of a subroutine. If you have a program that 
you know you will want to BREAK repeatedly, include 
a command that will BREAK the operation at some 
controlled point. Something along the line of 


IF INKEY$=B THEN GO TO... 








followed by some address that will stop th? program 
without interrupting a subroutine, 


Of course, you can also sweep the debris ot of 
that corner of memory by using the KUN or CLEAR 
instruction, but only at the cost of losing every 
other bit of data that the computer has saved up 
for you. 


I suppose that the same principle applies to the 
ZX81/TS1000 as well, but the Umit seems to be well 
above the practical range. I ran out of patience 
(with the TS1500, actually-~I hope that I'm right 

in assuming that the same rule holds for the 1000) 
when N got up to 1,200. 


LO\\\ 
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Basil Wentworth 


This chapter will give you a look into "real life", 
and will show you how to make a “rough draft” of 
your programs in BASIC, 


I always find it easier to debug my programs in 
BASIC before actually translating them into machine 
code, as the results of an error are much less 
drastic in BASIC. However, I try to make my BASIC 
program look as much like the final machine code as 
I can, in order to minimize errors in translation. 
This results in a far-from-efficient BASIC program, 
of course, You'd have much the same situation if 
you tried to write a sentence in English so that 

you could translate it word for word into correct 
Spanish, Your final product could look very much 
like: “Themselves to me they lost my pencils". 


But even before the rough draft, you'll have to 
have an idea of where you are going. Here you'll 
find the table called "The System Variables" very 
useful. This table begins on page 134 in the ZX81 
manual, and on page 262 for the TS 2068, 


So What To Do? 


Let's start out with that famous line renumbering 


program. For this application, you should remember 
the following facts: 


1. The first byte of the program is at 16509 for 
the ZX81. For the TS2068, the location of the first 
byte is given by 


PEEK 23635 + 256 * PEEK 23636 
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which is 26710, unless you have POKEd 23635 or 
23636. 


2. The end of each line is marked by 118 in the 
ZX81, by 13 in the 2068, 


3. Each line invariably starts with a sequence of 
the following four bvtes: 


a. Two bytes giving the line number in 
256-imal, MOST significant byte first, 


b. Two bytes giving the line length in 
256-imal, LEAST significant byte first. This length 
is the number of all bytes POLLOWING the 
line-length bytes, INCLUDING the 118 (or 13) at the 
end of the line. It does not, of course, include 
the bytes marking the line number nor does it 
include the line-length bytes, 


To illustrate, write the very short program 


10 LET BC=10 


and PEEK the first 17 bytes. You will see: 


0 0 
16 10 
13 13 

gi 0 


(. .i% more bytes. .) l 


13 118 


for the 2068 and the 2X81, respectively. The two 

digi:s 12 and 0, in 256-ima! (least signifirart 

byte first), give the number of bytes remaining in 

the line, INCLUDING the line-end indicator 13 or 

118. The two bytes 0 and 10 give the line number, 
MOST significant byte first. 


Now to put our knowledge to work. Remember that 
this program will foul up all GO TOs and GO SUBs, 
unless you carefully design the program (as we 

will) to avoid that problem, 


First, you must decide which register to use for 
each variable that you have to work with. The mest 
significant factor affecting your choice will be 

that you can do things with HL (a 2-byte register) 
and A (one byte) that you can't with the others, 
They sre the true workhorses of the computer. The 
next consideration is that instruction 235 provides 

a one-byte provision for exchanging DE and HL. This 
makes DE the best choice for an alternate 
workhorse. BC gets whatever is left. 


Now, what we're going to do in the line-renumbering 
program is to look at each byte in succession. When 
we reach an end-of-line, we pay special attention 

to the next two bytes (the line number), POKEing in 
the number that we have planned for that location. 
We have to include some provision for stopping the 
program when we're finished, And we mustn't forget 
the RETURN to BASIC when we finally get around to 
writing the machine code routine. We'll leave the 
first program line number unchanged, at 1. This 
might very well be the place where we store the 
machine code in the final version. 


Apparently, we're going to have to search through 
the memory, byte by byte. HL seems a logical choice 
for this function. Then we're going to have to keep 
a record of what the next line number must be, A 
logical use for DE, BC, then, can remember the 
interval between line numbers--a value that will 

not change. And A will be useful to set the target, 
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as it were, for each phase of our search. Register 
A is a particularly happy choice for this purpose, 
because of the existence of the CP instruction. 


For the ZX81 


Let's take the ZX81 case first. Start with the 
following program: 


1 REM 
10 LET HL=16509 
20 LET BC=10 
note: interval between line numbers 
30 LET DE=10 
note: number of first line 
40 LET A=117+1 
note: remember that 118 is a 'no-no' 
50 LET HL=HL+1 
60 LET CP=A~PEEK HL 
70 IF CP<>0 THEN GOTO 50 
80 PRINT 256*PEEK (HL+1)+PEEK 
(HL+2) 


Now RUN this much of the program. The number 
PRINTed should be 10. Insert (temporariiv) 


2 REM 


and RUN again, The resuit should be 2. DELETE line 
2. Now add 


90 LET A=35 
100 LET HL=HL*+1 
110 LET CP=A-PEEK HL 
126 IF CF:=0 THEN STOP 
note: will be RETurn in M/C routine 
note: this will stop the program as soon as 
the line number under consideration exceeds 8960 
(=35*256) 
210 GOTO 40 


, 


Now RUNning the program will give a list of all 

line numbers from 2 to the first one over 8960, 
Experiment by inserting other REM ines, and 

RUNning again. Be careful, however, that you DELETE 
all the extra lines, and restore the program to its 
present fa:m before going on to the next step. This 
is so that the GCTOs will still work after the 
renumbering process is carried cut, 


Now continue: 


130 LET D=INT (DE/256) 
140 LET E=DE-256*D 

150 POKE HL,D 

160 LET HL=HL+1 

170 POKE ĦL,E 

171 STOP 


Now another test. Change line number 10 to 2: then 
RUN. If you have followed instructions correctly, 

the line number will be changed back to 10 again. 
Now we're coming down the homestretch. DELETE line 
171, and add lines 9000 to 9030 to provide a 
subroutine that simulates the function that 

exchanges DE and HL: 


9000 LET TEMP-HL 
9010 LET HL=DE 
9020 LET DE=TEMP 
9030 RETURN 

and 


180 GOSUB 9000 
130 LET HL=HL+BC 
200 GOSUB 9000 


mam ~ 
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And line 210, of course, still reads GOTO 40. An Unorthodox Application 


For a final test, add a few REM lines betwen 211 
and 8960. You may change line numbers lower than 


210, if you wish, but make sure that the GOTOs and And now, what do you do with such a routine? Well, 

GOSUBs will be valid BOTH BEFORE AND AFTER the of coursa, you coul use: ft to-clean’ up your 

renumbering. Any numbers above 8960 (-256'35) will programs (taking due care with GO TO and GO SUB 

be unchanged. And, of course, you can change this addresses), But here is another application that 

limit to any multiple of 256 that you wish. You can wight not have occurred to you: 

also set it to other limits, but the procedure 

takes a couple more bytes of machine language Suppose you are preparing an index--say, of 

program. composers, You may want a simple LISTing, in which 
i case you just put the names in REM lines, or you 

For convenience, I'd suggest that you change line may want it to provide printout, in which case you 

80 to a REM (but don't DELETE it, lest you mess up use the command PRINT. You start out confidently 

the GOTO addresses). If you'd prefer to keep it, like this: 

then you'll have to CONTINUE after the screen fills 

up with line numbers, 10 REM BACH 


20 REM BEETHOVEN 
30 REM BRAHMS 


For the 152068 | BERLIOZ can gc in as line 25: BORODIN as 27. BERLIN 


would take line 22. Maybe BASIL in line 15, Pretty 
soon, your list looks like this: 
The 20608 procedure is a little bit more scary, 


because, as you have seen, you can run into 13's 2 REM BACH. CPE 
that aren't end-of-Line indicators. (Theoretically, 5 REM P ACE, Ic 
you could hava this problem with the ZX81, but oniy 10 REM BACH, JS 
if you run into a line long enough so that the 15 REM BASIL 
line-lenyth inaicator contains a 118), With that 2C REM BEETHOVEN 
one warning, the 2068 procedure follows very 22 REM BERLIN ; 
closely that of the ZX81, like this: 25 REM BERLIOZ 
26 REM BIZET 
i REM 27 REM BORODIN 
10 LET hl-PEEK 23635+255*PEEK 30 REM BRAHM3 
23636 
20 LET be-10 But HEY! Where are you going to put Bordognif Or 
30 LET de=16 Seth Bingham? And what to do with the rest of that 
40 LET a=13 nuge Bach tribe? 
50 LET hl=hi+1 
60 LET cp=a-PEEK hl Easy. Just renumber, and the above set will look 
70 IF ep<>0 THEN GO TO 50 like this: 
80 PRINT 256*PEEK (h1+1)+PEEK 
(hi+2) 10 REM BACH, CPE 
210 GO TO 40 20 REM BACH, JC 


30 REM BACH, JS 
40 REM BASIL 


when you RUN this program, you get all of the line 50 REM BEETHOVEN 

jumcers, but there are also spurious responses 60 REM BERLIN 

aliour 20, 30, and 40. The first result from tne 70 REM BERLIOZ 

icoi taat lines 29 ard 20 each have indicated line 80 REM BIZET 

length of 13 bytes; line 40 gives trouble because 90 REM BORODIN 

the 13 is explicitly expressed, The search through 100 REM BRAHMS 

all the hl's reads these 13's as if they were ends 

of lines, Plenty of room (for insercions, even when a Billings 


or a Birmingham turns up. 


This problem can be corrected by changing lines 20 
through 40 as follows: That's all for now. There will be more. 


29 LET be=S$+1l 
30 LET DE=9+1 sessessevosseeseseeosereceveo00 


40 LET a=12+1 


Now fill in the rest of lines 90 through 200 as 
above, 
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The translation to machine code should be very 
Straightforward. Just remember that the POKE and 
PEEK functions are represented by parentheses, 
like 






LD (HL),N LD hl,(NN) 





and the like, 
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Dear Timex — Sinclair User, 
TS-2068 - Sinclair QL - ' Sinclair Z88 


UPDATE Magazine is expanding. The October 1988 issue will begin coverage of the 
Sinclair QL, the 288, and the TS-2068. UPDATE Magazine does not seek to drew away 
subscribers from other publicatins but rather to support the users with a new and 
unique group of services. UPDATE highly recommends that all users sutscribe to Time 
Designs, Syncware News, and Quantum Levels magazines (As well as UPDATE). This way 
the users will get 85% of ALL information published about the user's computer systan. 
The other 15% comes in User Group Newsletters. 


UPDATE has a year of publishing under the belt and his a pretty good idea about 
what the users want. UPDATE is not "casual reading", but is ''Programming Intensive". 
Programning is covered from Beginner to Advanced level. Other features of the 
magazine are Reviews, Telecomputing, Disk drive systems, Hardware projects, and 


Peripheral devices. 


UPDATE is a "participating" magazine. Most of the articles ard utilities 
presented in each issue are by Guest Writers. These writers are the experts amongst 
us who freely give their programming expertise out of their Cesire to help others. 
Why a Quarterly magazine? Well, it takes three morths to put together an issue of 
UPDATE. All of the programs and utilities are NEW, and need to be tested. Complete 
instructions are given in the UPDATE pages. Then there is the “Issue Disk" to 


assemble, 


The Kev-in projects vary from "one liners?” to extensive softwares. These 
programs and utilities of each issue are offered in "Issue Disks" at a very low price 
for those who want ready to use programs. UPDATE shares the proceeds from Issue Disk 
sales with the contributing authors. This is just a token to show appreciation for 
their efforts and to pay for their expense. The Issue Disk is suoplied in all disk 
formats, and for the TS-2068 Oliger DOS, Larken DOS, and Aerco FD-68 DOS. 


A primary goal of UPDATE is to sponsor the development of DISK BASED software and 
utilities for the three computer systems. Already, this goal is being realized for 
the TS-2068. In the case of the QL, UPDATE will offer Disk Software and utilities, 
plus a dubbing service for those who use MDV only. North American software sources 
will be developed. There is a critical shortage of useful QL utilities because of the 
low profit potential for such programs. QL utilities will be of continuing emphasis. 


You are cordially invited to SUBSCRIBE TO UPDATE MAGAZINE. Subscription is 
$15.00 per year of issues. Four back issues are available for $15.00. These back 


issues cover the TS-2068 only. | 


To subscribe, send $15.00 to UPDATE Magazine, 1317 Stratford Ave., 
Panama City, FL 32404, (personal check O.K.) l 





INDEX 
UPDATE OCTOBER 1988 ISSUE 


si 


General Information CLUBS 
kaw sest aa i esi Computer Societv 27 
Invitation to Writers 48 Mil > TR QR 25 
Issue Disks 6, 72 waukee, WI TSUG 33 
MDV Dubbing 6, 72 SINCUS, New York 8 
North American User Group 8 Pasa Canada TSUG 33 
SINCLAIR 288 12 ancouver, Canada TSUG 17 
Supply Support 15, 70-73 
Writer's Format 43 
ADVERTISING RATE SCHEDULE——— page 77 
ZX APPEAL 17 
SINCUS NEWS 8 
PLOTTER 25 
BoSTUG 27 
SINC-LINK 33 
QZX 40, 17 
UPDATE SOFTWARE 1 LIBRARV —-——— page 74 
TS-2068 Articles ard Subjects Qu articles and Subjects 
Align Decimals — il ARCHIVE Tutorial 56 
Color Screens Copv 9 Address File Program 44 
Disk Multi Mgr (Oliger) 21 Arithmetic for Kids 64 
Extra Memory Recap 49 Beg.nner Course 30 
Extra Memcry, Charles Bothner 50 CABLE Column | 56 
Graphics LPRINI 25 CABLE ISSUE DISK/MDV CART 69, 72 
Hex Printer Dump 25 COPY MDV Cartridge 23, 31 
INIeger Function ll HELPER, Super Basic Tool Kit 63 
Interface For Color Copy 9 Initializing SPEED SCREEN 23 
LPRINI CHRS 25 Initializing TK2 23 
MAX DOS 3 Stacked DOS's 2 Microdrive Formatting 23, 30 
MSCRIPT for LKDOS 34 PRINT Primer 32 
CN ERR Tutorial 14 QL Tips 23 
CPEN#, CLOSE#, Streams 36 QUILL, Configure printer 31 
Ckimate 20 Printer 9 QUILL, File Saver 29 
PRINI USING - | 11 QUILL, LLISTing with 31 
Round Numbers UP ll RAM EXTENSION 19 
TOS DISK with CS-64 13 REFIELD, a Major Software 60 
Telecomputing 4l SCAN, an ARCHIVE Software 65 
Test Printer ' 25 Sound Experimentor 18 
TAX Software to beat Deadline 15 
TELECOMPUTING 17, 41 
. TELECOMPUTING with PACKET 42 
3 TOOL KIT 2 . i 
UPDATE MAGAZINE ee CANG ocroBEA 1688 





The UPDATE USER GROUP ISSUE 


UPDATE adds this insert to the copies going to User Group Clubs. Call it 
an Open Letter if you wish. While the content is not confidential, it has 
more applicability to the officials of user group clubs than to the general 
public. A couple of gaffs were made in the relative placement of Club 
Newsletters, where the SINCUS publication was promoted to first place. Since 
UPDATE was at the printers when the mistake was caught it could not be 
corrected. I expect quite a few letters about this. 

This issue of UPDATE begins a concerted effort to make Sinclair Users 
want to join their nearest TSUG. You may THINK that your group has most of 
the Sinclair users in your area, but that probably isn't so. There are less 
than 1/3 of the users of the QL who belong to any TSUG. In the past issues of 
UPDATE we enticed quite a number of TS-2068 users to join a TSUG in order to 
receive the club newsletter. I know that this payed off because a number have 
told me that they joined at least one TSG am some joined two or more. 

So, I kinda spread it on thick about the value of Club Newsletters in 
this issue, mainly to the QL users. This cost UPDATE about 20 extra pages ard 
around $400 of extra printing ami mailing costs, but thats alright, the sample 
re-prints of articles resulted in more value to the subscribers as well. I 
will do this again in the next issue and cover some other Club Newsletters. 
If you would like to have a print out of the QL users in your area to solicit 
for members, call or write and I'll run off a ccpv of tie UPDATE mailirg list 
for vour State. There are about 2500 (L users in UPDATE's mailing list which 
will include at least 25 or more in your area. Thev are not all subscribers, 
but we're working on that. 

HOW GOES IT in Sinclair ‘Comput ing amd the USER GROUPS? A little study 
about where we stand follows. This is has both facts and opinion, ami it 
tries to put a subject into focus, "SNUG". | 


The Sinclair North American User Gecup 
-a study by Bili Jcnes 


The subject has been under discussion since the ZX-89 hit the shores of 
North America. The Florida groups re-opened up the sucject during their 
Winter Fest in Orlando in March 88. At that time, all of tw magazine 
publishers pledged publicity support to help push the fcrmaticn of sucn a 
group. Now canes QZX Newsletter with a "Form tc fill cut amd return to SNUG". 
That would be fine, ard I would zap the form in to become a member, but there 
are some misgivings. Alex Burr, editor of QZX, published the SNUG 
information, but he also expressed some reservations and thoughts that should 
be considered. 

I believe that we need such an organization, but one having a much 
broader set of objectives than those expressed in the SNUG membership 
questionare. And, it appears that a "dual membership" concept is developing 
which will compete with existing TSUGs for members. I would like to help 
publicise and promote the organization efforts, but now I find myself to be in 
disagreement with the objectives expressed. In stort, the list of objectives 
have little BEEF, are unimaginative, am do not provide sufficient purpose for 
forming such an organization. 

There is another factor missing in the organization planning. That is 
the seeming lack of participation by the existing elected officials of the 
active TSUGS. You club officials are the only people who actually “represent 
someone", and are the only ones who can get a cross section of recommendations 
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needed to formulate the purpose and direction of a North American group. To 
understand the need for a North American User Group we need a brief lock-back 
and then an analysis of where we stand today. 

+ 


A Short History of TSUGS in North America 


ATTRITION set in amd has continued over several years since Timex stopped 
producing the TS-2068. The attrition of Sinclair users and club members 
steadily reduced the User Group memberships and the groups began to disolve. 
The result was that a few of the stronger clubs became "regional" clubs, and 
the rest faded away. Some of these clubs remained in name only, having fewer 
than a dozen members. This synopsis reaches up to the present, but without 
defining the NUMBERS. | 

During the March 88 Fest in Orlando there were some phenonomons evident 
that I attempted to analyze. That event was well publicised but poorly 
attended. As I circulated and talked with attemdees, figures began to develop. 
Of the attendees, about half were TS-2068 users, 45% were QL users, ad the 
other 5% were split between TS-1000 users ami "che curicus', Just during the 
few days of the Fest, at least a hundred new Sinclair Ls were sold by A+ 
Computers, which was amazing considering that criv 3C0 cr so people were in 
attendance. Strangely, only about half of the QL users prezent at the Fest 
were members of User Group Clubs. We will explore that later. 

THE NUMBERS: NUMBERS are confounding. Before and during tie Crlandc Fest 
I had heard some ridiculous estimates of the existing Timex Sinclair user 
population. Such figures as 100,000 and one Million were bandied about. This 
gross overestimation of population, I believe, is pervasive amongst the 
planners of Fairs, ami explains their terrible let down when only a couple of 
hundred show up at an event. 

My own estimates will be stunning to some, but they are collatcrated ky - 
several active dealers, ard are listed by camruter type as follcws: 

There ere fewer than 1500 active users of the TS-2068 comzuter ir North 
America. Most of the "very active" TS-2063 users have upgraded to Disk Drive 
and these number around 800. Although small in nurtezz, tnis group his strong 
"staying power" because of their high investment and cedicatior. 

For all practical purposes the TS-IOCO users are so few and ars so 
scattered as to be insignificant. The number? Try about 300 in ali of ikrċn 
America. 

There are around 5-70G0 Sinclair QL users in North America. Approximately 
half of the OL users were, or are, TS-2068 owners amd are now learning the QL 
ard are beginning to use it almost exclusively. The other half of the QL owner 
population did not previously own a Sinclair Computer. 

In summary, the TOTAL Sinclair Timex user group now numbers between 6000 
and 8000, and are predominately QL users. BUT there is room for OPTIMISM. The 
QL owner figures are being increased by dealers moving out a recently acquired 
stock of around 1000 (Ls from England. A few more batches of QLs may be found 
and imported. Most importantly, it is very likely that production of QL 
computers will resume, and that the "New (L' will have a built in 3.5" drive, 
without microdrive and will be priced at around $500. The 288 user group is 
just now starting to develop, amd has some strange twists to be considered. I 
predict that 1989 will see at least 20,000 or more Z88 Computers in use in 
North America, and an influx of new Cis under a different name. 


The Complexion of Timex Sinclair User Clubs 


Despite the predominance of QL users, the membership rolls of our most 
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active User Clubs are mostly TS-2068 users. The total TSUG membership in all 
of North America is reported (by the clubs) to. be around 1500. These clubs are 
still caught in the ATTRITION of the TS-2068 as equipment fails, and as users 
purchase other computers. AND, unfortunately, many of the QL users who did not 
previously own a TS-2068 have not seen any advantage of joining existing clubs. 
In the medium term, Clubs can survive only if they are successful in enticing 
QL users to join. A study of the Time Designs User Group listing, presented in 
the May June issue, reveals some interesting facts. Twenty-eight of the listed 
Clubs reported membership as 15 members or less. The TOTAL membership of all 
clubs in North America, reported was 1663. It appears that a sizable number of 
the members counted are "the same persons" who belong to several clubs in order 
to receive the club newsletters. AND, there are only 9 clubs that reported 
over 50 members. The net result is that there are probably not more than 1200 
total members of TSUGS in North America. This parallels the previous estimate 
of ALL TS-2068 and TS-1000 users. 7 
‘While the near future sees the QL USERS as the dominant group of users, 
the 288 group will likely take over first place during the first half of 1989. 
These two user groups represent the future health of the Sinclair user group 
clubs, but only if these users can find a common interest with the existing 
clubs. . If the clubs cannot, or wont adjust their programs to take in tie 288 
and (L users, amd make an effort to recruit them, those users wiil form their 
own special interest clubs and the existing clubs will continue their attrition 
cycle. ` .The Z88 sales, so far, have been mostly to people who have never owned 
a Sinclair or Timex Computer. While this makes a problem of first finding ard 
then enticing 288 users to join a TAG, it has a possible benefit of ADDING 
numbers to the user group instead of reducing the numbers of another group. 


The North American Sinclair User Group 
What the Objectives should be. Si 


Finally, we come back to the idea of a North Arerican Sinclair Society, 
the need for it, how such an organization ccuiċ de put together, what it should 
do, etc. It is obvious, from the foregoing, that the existing User Clubs need 
to re-vitilize themselves by recruiting QL ard 285 user momrers. But they lack 
information as to WHO the new users are and how to get in touch with then. A 
North American Group could develop mailing lists, in coordination with dealers 
and the magazines, and could develop a coordinated effort of recruittent with 
the existing TSUGS. This could coincide with an effort to balar tie Club 
programs to serve the interests of TS-2068, QL, and 288 users, in order to make 
the clubs more attactive to all users. Such a recruiting program "to input new 
members to the existing clubs" should be the foremost objective of the user 
group organization. A successful recruiting program should result in at least 
4000 .new TSUG members, a four fold increase over present membership. Also the 
program should capture mst of the new 288 users as they purchase their 
computers. Actually, most folks who are learning a new computer want to join a 
user group if the group has some educational benefits to offer. 

A User Group Publication is needed. At this time the only effective 
communications links are the magazines with their subscribers, amd the dealers 
with their customers. While the magazines have been supportive of the User 
Group Clubs, their objectives are primarily to serve the subscribers. A User 
Group publication should go beyond that scope. Eventually the user group 
publication could become the central publication for all user groups, taking 
input articles from the regional clubs and relieving them of publishing 


expenses. . 
A North American User Group could provide educational and organizational 
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assistance to regional user group clubs, charter them, and help to stardardize 
their programs. : 

The user group could coordinate with the dealers, hardware producers, and 
software writers to help develop North American sources and assist in 
Marketing. Such coordination should support "fair price"+ marketing, which 
would encourage our software programmers to produce— instead of attempting to 
force valuable software into public domain. The Shareware concept is the 
perogative of each programmer to engage in, but has proven to be non-profitable 
to them and most have already realized this fact. There is no free lunch ard 
any effort to continue the “baggie for $5.00" concept will be destructive. 
Authors have the perogative of donating their work to Public Domain, ard 
usually do that when a market cannot be developed for the software or utility 
title. To have adequate software support, adequate compensation for 
programmer's work is the essential ingredient. This concept of encouraging 
productivity is a healthier approach than the (implied) objectives in the SNUG 
form of exericsing pressure influence over our suppliers and the emphasis upon 
public domain which the existing clubs have already exploited. 

— There is really nothing wrong with the existance of small clubs which 
consist of 'single type! computer users. They just heve nothing much to offer 
except to the users of that specific computer. These ciuts could still exist 
and become affiliated with larger ‘regional’ user groups which would have 
broader programs ard have the ability to provide assistance. In fact, more 
such branch clubs would likely evolve; "QL Sub-groups, Z88 Sub-groups, TS-2968 
Sub-groups', and even perhaps a few TS-1000 sub groups. 


How a North American Sinclair User Group can be Formed 


Can there be a North American Sinclair Group? My answer is a qualified 
"Yes"—— but only if strong am worthy objectives are developed beforehand, and - 
only if our existing User Group Club officials step in and become the principle 
organizers. This mostly depends upon whether leadership can be generated from 
within the user groups. It will require the elected officials of cur clubs to 
first sell the idea to the members, then coordinate with the officiais of 
sister clubs to form up the North American Group charter and py laws. The next 
step would be these officials electing a beard of govenors of the NA group, ard 
then to "commit their club to operate under the guidance of the North Arerican 
Group". We surei; wouldn't want seperate merbexzhip where some would Sslong to 
the "super group" amd not belong to a local cr regional chapter, would we? 

IF the leadership develops and the existing user group clurs get the 
planning accomplished, the magazines will publish news releases, editorialize, 
ami provide the publicity needed to make the efforts successful. The magazines 
amd dealers can supply the mailing lists needed to contact all active users of 
Sinclair computers to invite them to join their nearest User Group Ciub. 

I believe that a North American Group, having these chartered objectives, 
and working in concert with our existing User Group Clubs, would serve the 
interests of Sinclair Computing and the users. But, a separate group having 
"at large" membership would be counter productive and would detrimental to 
existing user group organizations. 

All of this will require volentary efforts, dedication, and hard work by 
the organizers. It wont be easy to revitilize our current user group and start 
over with a new set of goals. Despite these tough problems a few brave souls 
may take up the challange and do the job. When that begins to happen the 
support amd help of all will be deserved. UPDATE Magazine stands ready to 
fully support the effort. In the interim, UPDATE will publish the views of 


your club organization, if supplied. 
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